home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr10 / pageit.zip / PAGEIT.DOC < prev    next >
Text File  |  1993-06-06  |  19KB  |  404 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                  PageIt v1.0
  9.  
  10.                        Page Sort Routine for Text Files
  11.  
  12.          ╔═══════════════════════════════════════════════════════╗
  13.          ║                                                       ║
  14.          ║                                                       ║
  15.          ║             (c)opyright 1990 by R.L. Amans            ║
  16.          ║                         7/09/90                       ║
  17.          ║                      313-373-7904                     ║
  18.          ║              CompuServe I.D. = 72716,1522             ║
  19.          ║                                                       ║
  20.          ║                                                       ║
  21.          ╚═══════════════════════════════════════════════════════╝
  22.  
  23.                                                               PageIt (TM) v1.0
  24.                                                               ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  25.                                                                   User's Guide
  26.                                                                   ▀▀▀▀▀▀▀▀▀▀▀▀
  27.                                                                             by
  28.                                                                             ▀▀
  29.                                                                Robert L. Amans
  30.                                                                ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  31.  
  32. Changes are periodically made to the information contained herein.  These
  33. changes will be incorporated into future editions of this publication.
  34.  
  35. Contact the person below with comments and questions:
  36.  
  37.                                 Robert L. Amans
  38.                                 3242 Salem Dr.
  39.                            Rochester Hills, MI 48306
  40.                          CompuServe I.D. = 72716,1522
  41.  
  42.  
  43.  
  44. PROPRIETARY NOTICE
  45.  
  46. PageIt (TM) is a proprietary product published by Robert L. Amans, Rochester
  47. Hills, Michigan.  PageIt is Copyright R.L. Amans - 1990.
  48.  
  49. All rights reserved except those expressly granted in writing to the user, or
  50. by this document.
  51.  
  52. Review the README.txt file on the distribution disk for information pertaining
  53. to PageIt (TM) that may not be included in the documentation.
  54.  
  55. DISCLAIMER
  56.  
  57. R.L. Amans hereby disclaims all warranties relating to PageIt (TM), whether it
  58. is expressed or implied, including and without limitation to any implied
  59. warranties of merchantability or fitness for a particular purpose.  R.L. Amans
  60. cannot and will not be liable for any special, incidental, consequential,
  61. indirect or similar damages due to the loss of data or any other reason
  62. through the use of PageIt (TM), even if R.L. Amans or an authorized agent has
  63. been advised of the possibility of such damages.  Further, in no event shall
  64. the liability for any damages ever exceed the price paid for the license to
  65. use PageIt (TM), regardless of the form and/or extent of the claim.  The user
  66. of PageIt (TM) bears all risk as to the quality and performance of the
  67. software.
  68.  
  69. LICENSE
  70.  
  71. PageIt (TM) is a Shareware product.  As such, it is made available to the
  72. general computing public for evaluation.  Users are licensed to operate PageIt
  73. (TM) on their personal computers for the purpose of test and evaluation on a
  74. trial basis for a limited period of time.  If the user decides the program is
  75. not of sufficient merit to warrant purchase through registration with R.L.
  76. Amans, program use should cease.  Otherwise, if the program is deemed useful
  77. and is in regular use, registration with R.L. Amans is required.
  78.  
  79. Registered users are those users that elect to pay for PageIt (TM) and
  80. register that payment with R.L. Amans.  By virtue of registration and payment
  81. for the program, registered users are granted a license to continue to utilize
  82. the program for as long as they choose.  This license authorizes the user to
  83. use the program on any personal computer system so long as the program is
  84. operated on only one computer system at a time.
  85.  
  86. PageIt (TM) is a fully functional Shareware product.  Shareware is a computer
  87. program distribution/marketing method that permits potential buyers to
  88. thoroughly try the program prior to purchase.  It is NOT free and it is not in
  89. the Public Domain.  If, after evaluating the program, you find it to be useful
  90. enough to use it on a regular basis, you are expected to pay for it by
  91. registering with R.L. Amans.  Technical support will be provided through two
  92. means: 
  93.  
  94.     1) By phone: (313)-373-7904 
  95.     2) Electronically through CompuServe: 72716,1522
  96.  
  97. I do my best to support my software.  One of the great strengths of the
  98. Shareware concept is the interaction between the program author and the users.
  99. Many of the features contained in PageIt (TM) are the result of user input.
  100. If you have a problem evaluating this program please do not hesitate to
  101. contact me.  Technical support will be available through the U.S. mail,
  102. telephone, or CompuServe.
  103.  
  104. REGISTRATION (See the form at the end of this document)
  105.  
  106. PageIt (TM) is the sole property of R.L. Amans.  The shareware version may be
  107. freely copied and transferred to individual parties for evaluation purposes.
  108. It may be posted on Bulletin Board systems (BBS) for electronic access as long
  109. as NO FEE is charged for its distribution except for private BBS operations
  110. that charge a regular user subscription fee.
  111.  
  112. PageIt (TM) may NOT be distributed on diskette by any disk distributor/vendor
  113. that charges more than $10.00 for the diskette upon which the program and
  114. attendant files are recorded without written consent from R.L. Amans.
  115.  
  116. PageIt (TM) is a Shareware product, Copyright 1990 by R.L.  Amans, all rights
  117. reserved.  Disk vendors who distribute Shareware and public domain software on
  118. 5 1/4" and/or 3 1/2" floppy diskettes are permitted to distribute PageIt (TM)
  119. providing that the vendor's fee is less than $10.00 for the disk containing
  120. PageIt (TM) files.  Vendors who charge more than $10.00 per disk are
  121. PROHIBITED from distributing PageIt (TM) in any form without expressed written
  122. consent from R.L. Amans.
  123.  
  124. Vendors who meet the above requirements may distribute PageIt (TM) only if
  125. ALL attendant files are included on the distribution diskette, and only if NO
  126. files are modified in any way. The PageIt (TM) files that MUST be included
  127. on the distribution diskette are:
  128.  
  129.     PageIt.COM   -  PageIt (TM) executable
  130.     PageIt.DOC   -  PageIt (TM) documentation
  131.     Readme.Txt   -  Misc update information
  132.  
  133. See the form at the end of this document please.
  134.  
  135. PURPOSE
  136.  
  137. PageIt (TM) is used when text files must be printed in "booklet" form.  This
  138. product is a "pre-processor" to the printing process.  It sorts the text file
  139. into the proper order for printing the text file "pages" on single sheets of
  140. paper to facilitate making a booklet.  The text file is then printed with a
  141. right or left leading page and the "pages" are printed on the front of the
  142. paper then on the back.
  143.  
  144. As an example, assume the text file was eleven pages in length.  PageIt (TM)
  145. would sort the pages and inform the user as to how many sheets of paper would
  146. be required.  The sort process is based on two "pages" per side of paper.
  147.  
  148. Output ...      Right Leading Page      Left Leading Page
  149. ▀▀▀▀▀▀▀▀▀▀        3 sheets of paper       3 sheets of paper
  150.                     page order:             page order:
  151.                 ═════════════════════════════════════════════
  152.                         6,7                     5,6
  153.                         4,9                     3,8
  154.                         2,11                    1,10
  155.           ... at this point the paper is placed back into the printer ...
  156.                        12,1 (12 is blank)      11,0 (same as 12 - blank)
  157.                        10,3                     9,2
  158.                         8,5                     7,4
  159.  
  160. USAGE
  161.  
  162. PageIt (TM) is not a text editor nor is it a print routine.  It imports a text
  163. file and sorts the pages into the proper logical order for "booklet"
  164. printing and saves the "new" file back to disk.  The new file is now ready to
  165. be printed through the use of another routine.  However, the package is very
  166. flexible and can even be used to provide multiple column output with the pages
  167. sorted.  Examples will follow this discussion.
  168.  
  169. PROCEDURE
  170.  
  171.     Step 1
  172.     ══════
  173.     Use a text editor to provide a "proof" ready document complete
  174.     with the headers, footers and pagination.  DP-Editor (TM), another
  175.     shareware product is good for this application.  However, any product can
  176.     be used.
  177.  
  178.     Step 2
  179.     ══════
  180.     Use PageIt (TM) to sort the document file created above into the proper
  181.     order for booklet printing.  The input file name and resultant output file
  182.     name is required.  The program then searches the file for page breaks
  183.     and tells the user how many "printed" pages are found.  PageIt (TM) then
  184.     asks if the file is to be right or left leading and finally informs the
  185.     user as to how many actual pages of paper are required.
  186.  
  187.     Step 3
  188.     ══════      
  189.     Place only those pages to be printed on into the printer.  The quantity is
  190.     noted in step 2 above.  Use the printing package of your choice to print
  191.     the text file.  DeskJet Landscaper (TM) is an excellent choice for this
  192.     process if the file is to be printed sideways on the Hewlett-Packard
  193.     Deskjet (TM) printer.
  194.  
  195.     Step 4
  196.     ══════
  197.     When the paper runs out on the printer - the fronts of the paper will
  198.     contain half of the text file.  Place the "used" paper back into the
  199.     printer.  Note, the last page printed will be the first page printed when
  200.     printing the backs.  Put the printer back on line and the second half of
  201.     the file will be printed on the back of the sheets.
  202.  
  203. PARTICULARS
  204.  
  205. PageIt (TM) is not a printing routine, nor is it an editor.  It is used to
  206. sort existing pages of a text file and prepare the order for "booklet" form
  207. output.
  208.  
  209. The output is processed through a file that is created to hold the sorted
  210. pages.  This is done to remove any file size limitations.  Therefore, insure
  211. enough room exists on the disk being used to hold a file about the size of the
  212. original.
  213.  
  214. If the original file includes page breaks, [Chr$(12)], they are removed and
  215. carrige returns and line feeds are inserted into the final file in their
  216. place.  This is done to insure compatibility with the widest variety of
  217. printing routines and printers.  (Mostly the original HP Deskjet printer)
  218.  
  219. Because page breaks are not used, and lines per page are; insure that the
  220. printing package used is consistant with the lines per page requirement.  That
  221. is, if the final print file is sorted with 61 lines per page being used as the
  222. actual page size, the print routine must also use a page size of 61 lines per
  223. page.
  224.  
  225. The order of sort is determined after the file size is determined and based on
  226. left or right leading pages.  The middle of the booklet is printed first and
  227. each "page" of the booklet below is printed in turn.  Printing is done
  228. "inside-out".  The facing pages are printed next.  Printing is started from
  229. the outside first and each page is then printed in turn.  Therefore, the last
  230. page printed on the first pass is inserted into the printer first for the
  231. second pass, etc.
  232.  
  233. Familiarize yourself with the order of printed pages because each printer
  234. handles pages differently.  For the HP Deskjet printer the process is as
  235. follows ...
  236.        ════════════════════ Deskjet printer process ════════════════════
  237.        1.» Print one side of the paper until the pile is exhausted
  238.                the pile is based on the paper count noted by PageIt (TM).
  239.        2.» Without resorting the paper, insert them back into the
  240.                printer in the same orientation they came out.
  241.        3.» After printing is complete reset the Deskjet and turn the pile
  242.                of paper over and manually resort the printed pages to put
  243.                them in booklet order for folding.
  244.        ═════════════════════════════════════════════════════════════════
  245. Resultant      Example - text file with 11 pages of text ...
  246. Output ...      Right Leading Page      Left Leading Page
  247. ▀▀▀▀▀▀▀▀▀▀        3 sheets of paper       3 sheets of paper
  248. Sheet of Paper       page order:             page order:
  249. notice order!  ═════════════════════════════════════════════
  250.       1                 6,7                     5,6
  251.       2                 4,9                     3,8
  252.       3                 2,11                    1,10
  253.       3                12,1 (12 is blank)      11,0 (same as 12 - blank)
  254.       2                10,3                     9,2
  255.       1                 8,5                     7,4
  256.  
  257. MISC
  258.  
  259. Multiple columns can be handled also.  Simply tell PageIt (TM) that the lines
  260. per page will be twice the actual.  (Use 122 lines per page and not 61)
  261. PageIt (TM) will then sort the original document with every two pages being
  262. combined.  Deskjet Landscaper (TM) can handle this nicely.  Try it!
  263.  
  264. USAGE
  265.  
  266. The command line call is:
  267.     PageIT <Input file> <Output file>
  268.  
  269. PageIt (TM) will check for the existance of both files and notify if the
  270. output file exists.  If it does, the user is asked if it should be
  271. overwritten.  If the response is no, a new file name is accepted.  If the
  272. input file does not exist, the program aborts.  A null response or <ESC> is
  273. used at the file query to abort the program.
  274.  
  275. The command line arguments are optional.  If they are not present PageIt (TM)
  276. will prompt for input and output file names.  It will then prompt for page
  277. size in lines per page, and if a right or left leading booklet is required.
  278.  
  279. Sample Screen:
  280. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  281.  ┌────────────────────────────────┐
  282.  │     PageIt by R.L. Amans       │
  283.  │ Copyright (c) R.L. Amans, 1990 │
  284.  │                                │
  285.  │ USAGE:                         │
  286.  │ PAGEIT Infile / Outfile        │
  287.  └────────────────────────────────┘
  288.  
  289.   What is the name of the input file?  B:\PAGEIT.DOC  « input file response
  290.   What is the name of the output file? B:\PAGEIT.PRN  « output file response
  291.  
  292.   What is the page size in lines per page? 61         « page size response
  293.   This document is 9 pages long                       « quantity of pages 
  294.   Do you want Right Leading? <Y/N> N                  « right/left leading?
  295.   The number of pages to print is 9                   « quantity of pages
  296.   The amount of paper to be used is 3 sheets          « paper needed for job
  297.                                                       
  298.                                                       
  299.                Printing page 4 to disk                « page sent to disk
  300.  
  301. CLOSING
  302.  
  303. Pay special attention to the Readme.Txt file for update information.
  304.  
  305. Thanks for your support and registering of this software package.
  306.  
  307.                                                               PageIt v1.0 (TM)
  308.  
  309.                                                                Robert L. Amans
  310.                                                               3242 Salem Drive
  311.                                                      Rochester Hills, MI 48306
  312.                                                                 (313) 373-7904
  313.                                                     72716,1522 CompuServe I.D.
  314.  
  315.                                    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  316.  
  317. ══════════════════════════════════════════════════════════════════════════════
  318.  
  319. PRODUCT PURCHASE FORM:
  320. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  321.  
  322. Products:
  323.  
  324.     ┌┐   Deskjet Landscaper v5.0    Sideways print routine for the HP
  325.     └┘                              Deskjet Printer.  ($20.00)
  326.  
  327.  
  328.     ┌┐   Dos Pro Plus               Dos file management system, shell
  329.     └┘   with                       and menu environment with many file
  330.          Dos Pro Utilities          utilities.        ($20.00)
  331.  
  332.  
  333.     ┌┐   DP-Editor                  Dos Pro Editor for the PC.  A full
  334.     └┘                              featured, but simple to use ASCII
  335.                                     editor.           ($20.00)
  336.  
  337.  
  338.     ┌┐   PageIt                     Booklet page sort routine for the
  339.     └┘                              PC.  Ideal for preprocessor to
  340.                                     landscaper above or other publishers.
  341.                                                       ($10.00)
  342.  
  343.  
  344.     Registration only:       ──────────────────────  (at $20.00 each)
  345.                              ──────────────────────  (at $10.00 each)
  346.     Shipping and handling:   ──────────────────────  (at $2.00 each)
  347.                     Total:   ──────────────────────
  348.  
  349.  
  350.     Name:         ───────────────────────────────────
  351.     Company:      ───────────────────────────────────
  352.     Address:      ───────────────────────────────────
  353.                   ───────────────────────────────────
  354.     State Zip:    ─────────────────────       ───────
  355.  
  356.     Phone Number: ──────────────
  357.  
  358.     Send check or money order to:
  359.             Robert L. Amans
  360.             3242 Salem Dr.
  361.             Rochester Hills, MI 48306
  362.  
  363. ══════════════════════════════════════════════════════════════════════════════
  364. PRODUCT REGISTRATION FORM:
  365. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  366.  
  367. Products:
  368.  
  369.     ┌┐   Deskjet Landscaper v5.0    Sideways print routine for the HP
  370.     └┘                              Deskjet Printer.
  371.  
  372.  
  373.     ┌┐   Dos Pro Plus               Dos file management system, shell
  374.     └┘   with                       and menu environment with many file
  375.          Dos Pro Utilities          utilities
  376.  
  377.  
  378.     ┌┐   DP-Editor                  Dos Pro Editor for the PC.  A full
  379.     └┘                              featured, but simple to use ASCII
  380.                                     editor.
  381.  
  382.  
  383.     ┌┐   PageIt                     Booklet page sort routine for the
  384.     └┘                              PC.  Ideal for preprocessor to
  385.                                     landscaper above or other publishers.
  386.  
  387.  
  388.     Product serial number:   ──────────────────────
  389.     Purchase date:           ──────────────────────
  390.     Place of purchase:       ──────────────────────
  391.  
  392.  
  393.     Name:         ───────────────────────────────────
  394.     Company:      ───────────────────────────────────
  395.     Address:      ───────────────────────────────────
  396.                   ───────────────────────────────────
  397.     State Zip:    ─────────────────────       ───────
  398.  
  399.     Phone Number: ──────────────
  400.  
  401.                                                           End of Documentation
  402.                                                           ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  403.  
  404.